home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / comm / www / OpenURL30.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  5.6 KB  |  129 lines
  1. Short:    Library for easily sending URL->Browser
  2. Author:   troels@thule.no (Troels Walsted Hansen)
  3. Uploader: troels@thule.no (Troels Walsted Hansen)
  4. Type:     comm/www
  5. Replaces: comm/www/OpenURL20.lha
  6.  
  7. Introduction
  8. ¯¯¯¯¯¯¯¯¯¯¯¯
  9. This library was created to make it easier for application programmers to
  10. include clickable URLs in their applications, about windows, etc.  Current
  11. solutions to this problem typically are to launch an ARexx script or just
  12. support a few webbrowsers, with no room for configuration.  This leads to
  13. countless reinventions of the wheel (how many SendURLToBrowser.rexx scripts
  14. do you have on your harddisk?).
  15.  
  16. This library solves the problem by giving application programmers a very
  17. simple API to handle (one function) and the user gets configurability with
  18. the included preference program.
  19.  
  20. NOTE: I like and use MUI, therefore the included preference program uses
  21.       MUI.  This library is meant to be completely universal though, so
  22.       programmers preferring other GUI engines are encouraged to program 
  23.       their own preference editor and send it to me, I'll happily include it.
  24.  
  25. Requirements
  26. ¯¯¯¯¯¯¯¯¯¯¯¯
  27.  · AmigaOS 2.0 or higher.
  28.  · MUI 3.8 or higher, for the preference program only.
  29.  
  30. Features
  31. ¯¯¯¯¯¯¯¯
  32.  · Sends URL by ARexx if your browser is launched, if not, the library will
  33.    launch the browser.
  34.  · Configuration supports a list of installed browsers, no Wind*ws "default
  35.    browser" nonsense.
  36.  · mailto: URLs can optionally be handled by an email application.
  37.  · Extremely simple API for applications.
  38.  · API also available for use from ARexx scripts.
  39.  · Complete source included for your enjoyment.
  40.  
  41. Usage
  42. ¯¯¯¯¯
  43. Using the preference program should hopefully be very easy.  A few tips
  44. might be helpful though.  The library will try contacting the browsers from
  45. top to bottom of the list, so put your favourite browser at the top (drag
  46. and drop).
  47.  
  48. The ARexx portname should be set to "BROWSER" even for browsers that call
  49. their ports "BROWSER.1", "BROWSER.2", etc.  The library will look for any
  50. port named "BROWSER.x" where "x" is a number and ".x" is optional.
  51.  
  52. For developers: see autodocs.
  53.  
  54. Legal stuff
  55. ¯¯¯¯¯¯¯¯¯¯¯
  56. The openurl package is placed in the public domain.  I assume no
  57. responsibility for what these programs might do, you are using them at your
  58. own risk.
  59.  
  60. Author
  61. ¯¯¯¯¯¯
  62. SnailMail: Troels Walsted Hansen
  63.            O.L. Aunesgate 15
  64.            9009 Tromsø
  65.            NORWAY
  66.  
  67. Email:     troels@thule.no
  68.  
  69. IRC nick:  Troels
  70.  
  71.  
  72. ============================= Archive contents =============================
  73.  
  74. Original  Packed Ratio    Date     Time    Name
  75. -------- ------- ----- --------- --------  -------------
  76.     5240    3443 34.2% 26-Sep-99 18:06:28 +OpenURL
  77.     8082    2397 70.3% 26-Sep-99 16:55:00 +openurl.doc
  78.      506     201 60.2% 25-Jul-99 18:20:20 +openurl_pragmas.h
  79.     1921    1046 45.5% 27-Jul-98 02:31:26 +Install OpenURL.info
  80.      808     541 33.0% 26-Sep-99 18:05:30 +OpenURL-Handler
  81.    10580    5581 47.2% 31-Aug-99 10:29:50 +Popplaceholder.mcc
  82.     5520    3185 42.3% 27-Mar-97 13:41:46 +Popport.mcc
  83.    10684    5736 46.3% 26-Sep-99 19:38:40 +openurl.library
  84.     1437     543 62.2% 27-Jul-98 02:31:26 +OpenURL.readme.info
  85.    19420    8703 55.1% 26-Sep-99 18:06:18 +OpenURL
  86.     1663     999 39.9% 27-Jul-98 02:31:46 +OpenURL.info
  87.      898     392 56.3% 26-Sep-99 18:58:42 +openurl_protos.h
  88.     4192    1320 68.5% 26-Sep-99 18:58:48 +openurl.h
  89.      185     128 30.8% 26-Jul-98 14:45:10 +openurl.h
  90.      428     258 39.7% 26-Sep-99 18:02:36 +debug.h
  91.     1585     743 53.1% 26-Sep-99 18:02:34 +Example.c
  92.     4694    1740 62.9% 26-Sep-99 18:02:36 +handler.c
  93.      813     405 50.1% 26-Sep-99 18:02:36 +handler.h
  94.    10637    3317 68.8% 26-Sep-99 18:02:36 +library_api.c
  95.     1265     498 60.6% 26-Sep-99 18:02:36 +library_api.h
  96.     1264     457 63.8% 26-Sep-99 18:02:38 +library_common.h
  97.    12175    2731 77.5% 26-Sep-99 19:34:16 +library_prefs.c
  98.      863     356 58.7% 26-Sep-99 18:02:34 +library_prefs.h
  99.    11908    3277 72.4% 26-Sep-99 18:02:38 +library_util.c
  100.      772     343 55.5% 26-Sep-99 18:02:34 +library_util.h
  101.     7218    2553 64.6% 26-Sep-99 18:02:34 +OpenURL.c
  102.     2407     823 65.8% 26-Sep-99 18:02:38 +prefs_app.c
  103.      981     415 57.6% 26-Sep-99 18:02:38 +prefs_app.h
  104.     9518    2069 78.2% 26-Sep-99 18:02:38 +prefs_applist.c
  105.     2405     651 72.9% 26-Sep-99 18:02:36 +prefs_applist.h
  106.     9166    2443 73.3% 26-Sep-99 18:02:36 +prefs_browsereditwin.c
  107.     1374     518 62.2% 26-Sep-99 18:02:34 +prefs_browsereditwin.h
  108.      850     405 52.3% 26-Sep-99 18:02:36 +prefs_common.c
  109.     4038    1262 68.7% 26-Sep-99 18:02:36 +prefs_common.h
  110.     8699    2417 72.2% 26-Sep-99 18:02:34 +prefs_mailereditwin.c
  111.     1337     515 61.4% 26-Sep-99 18:02:36 +prefs_mailereditwin.h
  112.     6915    1957 71.6% 26-Sep-99 18:02:36 +prefs_main.c
  113.      464     267 42.4% 26-Sep-99 18:02:36 +prefs_main.h
  114.      315     192 39.0% 25-Jul-99 18:15:30 +openurl_lib.fd
  115.    15878    4286 73.0% 26-Sep-99 18:02:36 +prefs_prefswin.c
  116.     1439     519 63.9% 26-Sep-99 18:02:36 +prefs_prefswin.h
  117.      286     196 31.4% 04-Feb-99 12:12:26 +ReadMe.txt
  118.     3616    1087 69.9% 26-Sep-99 19:02:56 +smakefile
  119.    23648    7558 68.0% 26-Sep-99 18:02:36 +SmartReadArgs.c
  120.     2863    1165 59.3% 26-Sep-99 18:02:34 +SmartReadArgs.h
  121.     2655    1035 61.0% 26-Sep-99 21:16:56 +Install OpenURL
  122.     7093    3266 53.9% 26-Sep-99 19:02:42 +OpenURL.readme
  123.     1197     694 42.0% 27-Jul-98 02:31:46 +Prefs.info
  124.      686     338 50.7% 26-Sep-99 16:17:42 +OpenURL.rexx
  125.     1188     559 52.9% 27-Jul-98 02:31:26  OpenURL.info
  126.     3500    1383 60.4% 15-Sep-99 19:30:26 +SendThorMail.rexx
  127. -------- ------- ----- --------- --------
  128.   237276   86913 63.3% 14-Oct-99 14:47:04   51 files
  129.